ARIA: aria-rowindex-Attribut

Einige Tabellen haben sehr viele Zeilen. Nur einen Teil der Zeilen zu laden, kann als Designanforderung dienen, um die Leistung zu verbessern oder die Benutzererfahrung zu steigern.

Wenn nur ein Teil der Zeilen geladen wird, müssen alle Nutzer wissen, welche Zeilenabschnitte angezeigt werden. Das aria-rowindex-Attribut wird verwendet, um den Zeilenindex oder die Position der Zelle oder Zeile in Bezug auf die Gesamtanzahl der Zeilen innerhalb einer Tabelle, eines Rasters oder eines Baumgitters zu definieren.

Enthalten auf dem <tr>-Element oder auf einem Element mit der Rolle row, oder direkt auf dem <td>, <th> oder Element mit der Rolle cell oder gridcell, ist der Wert die Position der Zeile in Bezug auf die gesamte Tabelle.

Der Wert für aria-rowindex ist eine ganze Zahl, die größer oder gleich 1 ist, größer als der aria-rowindex-Wert aller vorherigen Zeilen, und kleiner oder gleich der Gesamtzahl der Zeilen in der gesamten Tabelle.

Wenn alle Zeilen geladen und im DOM sind, müssen Sie aria-rowindex nicht einfügen, da Browser den Index jeder Zeile automatisch berechnen. Wenn jedoch nur ein Teil der Zeilen im DOM vorhanden ist, ist aria-rowindex erforderlich, um die Position jeder Zeile in Bezug auf die vollständige Tabelle anzugeben. Wenn nur ein Teil der Zeilen geladen wird, müssen Sie auch aria-rowcount auf dem Tabellen-Vorfahren hinzufügen, auch wenn Sie die Gesamtzahl der Zeilen nicht kennen.

Wenn die Tabelle mit nur einem Teil der Zeilen eine Zelle hat, die sich über mehr als eine Zeile erstreckt, müssen sowohl die Zeile als auch die Zelle das aria-rowindex-Attribut gesetzt haben. Wenn sich eine Zelle über mehr als eine Zeile erstreckt－wenn eine Zellrolle das aria-rowspan-Attribut enthält oder wenn eine HTML-Zelle ein rowspan-Attribut mit einem Wert größer als 1 hat－muss der aria-rowindex-Wert der Zeile auf die sich erstreckende Zelle zusätzlich zu dem entsprechenden Zeilen-Spann-Attribut gesetzt werden. Der Wert sollte der Zeilenindex der Zeile sein, an der die Spannweite beginnt.

Das folgende Beispiel zeigt ein Raster mit 24 Zeilen, von denen die erste Zeile und die Zeilen 7 bis 10 dem Benutzer angezeigt werden. Die letzte "Position"-Zelle erstreckt sich über die Spalten 9 und 10.

<div role="grid" aria-rowcount="24">
  <div role="rowgroup">
    <div role="row" aria-rowindex="1">
      <span role="columnheader">First Name</span>
      <span role="columnheader">Last Name</span>
      <span role="columnheader">Position</span>
    </div>
  </div>
  <div role="rowgroup">
    <div role="row" aria-rowindex="7">
      <span role="gridcell">Morgan</span>
      <span role="gridcell">Brian</span>
      <span role="gridcell">Midfielder</span>
    </div>
    <div role="row" aria-rowindex="8">
      <span role="gridcell">Abby</span>
      <span role="gridcell">Dahlkemper</span>
      <span role="gridcell">Defender</span>
    </div>
    <div role="row" aria-rowindex="9">
      <span role="gridcell">Ashlyn</span>
      <span role="gridcell">Harris</span>
      <span role="gridcell" aria-rowspan="2" aria-rowindex="9">Goalkeeper</span>
    </div>
    <div role="row" aria-rowindex="10">
      <span role="gridcell">Alyssa</span>
      <span role="gridcell">Naeher</span>
    </div>
  </div>
</div>

Beachten Sie, dass sowohl aria-rowspan als auch aria-rowindex auf der Torwartzelle vorhanden sind, die sich über zwei Zeilen erstreckt.

<integer>

Eine ganze Zahl, die größer oder gleich 1 ist, größer als das aria-rowindex der vorherigen Zeile, falls vorhanden, und kleiner oder gleich dem Wert von aria-rowcount.

Element.ariaRowIndex

Die ariaRowIndex-Eigenschaft, Teil der Element-Schnittstelle, spiegelt den Wert des aria-rowindex-Attributs wider.

ElementInternals.ariaRowIndex

Die ariaRowIndex-Eigenschaft, Teil der ElementInternals-Schnittstelle, spiegelt den Wert des aria-rowindex-Attributs wider.

Verwendet in Rollen:

• cell
• row

Geerbt in Rollen:

• columnheader
• gridcell
• rowheader

• aria-rowindextext
• aria-rowcount
• aria-rowspan
• aria-colindex
• Das rowspan-Attribut auf <td>